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About the Tutorial 



TestNG is a testing framework developed in the lines of JUnit and NUnit, 
however it introduces some new functionalities that make it more powerful and 
easier to use. 

TestNG is designed to cover all categories of tests: unit, functional, end-to-end, 
integration, etc., and it requires JDK 5 or higher. 

This tutorial provides a good understanding on TestNG framework needed to test 
an enterprise-level application to deliver it with robustness and reliability. 



This tutorial is designed for software professionals interested in learning the 
features of TestNG Framework in simple and easy steps and implement it in 
practice. 



Before proceeding with this tutorial, you should have a basic understanding of 
Java programming language, text editor, and execution of programs, etc. As you 
are going to use TestNG to handle all levels of Java project testing, it will be 
helpful if you have a prior knowledge of software development and software 
testing processes. 
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copy, distribute or republish any contents or a part of contents of this e-book in 
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precisely as possible, however, the contents may contain inaccuracies or errors. 
Tutorials Point (I) Pvt. Ltd. provides no guarantee regarding the accuracy, 
timeliness or completeness of our website or its contents including this tutorial. 
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1. OVERVIEW 



Testing is the process of checking the functionality of an application to ensure it 
works as per requirements. Unit testing comes into picture at the developer level 
where adequate measures are taken to test every single entity (class or method) 
to ensure the final product meets the requirements. 

JUnit has driven developers to understand the usefulness of tests, especially of 
unit tests, when compared to any other testing framework. Leveraging a rather 
simple, pragmatic, and strict architecture, JUnit has been able to "infect" great 
number of developers. Do take a look at our tutorial on JUnit to have a good 
understanding of its features. JUnit, at the same time, has some shortcomings 
as well, which are listed below: 

• Initially designed to enable unit testing only, now used for all kinds of 
testing. 

• Cannot do dependency testing. 

• Poor configuration control (setUp/tearDown). 

• Intrusive (forces you to extend classes and name your methods a certain 



• Static programming model (forces you to recompile unnecessarily). 

• The management of different suites of tests in complex projects can be 
very tricky. 



Definition of TestNG as per its documentation is as follows: 

TestNG is a testing framework inspired from JUnit and NUnit, but 
introducing some new functionalities that make it more powerful and 
easier to use. 

TestNG is an open source automated testing framework; where NG means 
NextGeneration. TestNG is similar to JUnit (especially JUnit 4), but it is not a 
JUnit extension. It is inspired by JUnit. It is designed to be better than JUnit, 
especially when testing integrated classes. The creator of TestNG is Cedric Beust. 

Eliminating most of the limitations of the older framework, TestNG gives the 
developer the ability to write more flexible and powerful tests. As it heavily 
borrows from Java Annotations (introduced with JDK 5.0) to define tests, it can 
also show you how to use this new feature of the Java language in a real 
production environment. 



way). 



What is TestNG? 
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TeslNG Features 



• Supports annotations. 

• TestNG uses more Java and 00 features. 

• Supports testing integrated classes (e.g., by default, no need to create a 
new test class instance for every test method). 

• Separates compile-time test code from run-time configuration/data info. 

• Flexible runtime configuration. 

• Introduces 'test groups'. Once you have compiled your tests, you can just 
ask TestNG to run all the "front-end" tests, or "fast", "slow", "database" 
tests, etc. 

• Supports Dependent test methods, parallel testing, load testing, and 
partial failure. 

• Flexible plug-in API. 

• Support for multi-threaded testing. 
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2. ENVIRONMENT 



TestNG is a framework for Java, so the very first requirement is to have JDK 
installed in your machine. 



System Requirement 



JDK 


1.5 or above. 


Memory 


No minimum requirement. 


Disk Space 


No minimum requirement. 


Operating System 


No minimum requirement. 



Step 1 : Verify Java Installation in Your Machine 



Open the console and execute a java command based on the operating system 
you have installed on your system. 



OS 


Task 


Command 


Windows 


Open Command Console 


c:\> java -version 


Linux 


Open Command Terminal 


$ java -version 


Mac 


Open Terminal 


machine:™ joseph$ java -version 



Let's verify the output for all the operating systems: 



OS 


Output 


Windows 


java version "1.7.0_25" 

Java(TM) SE Runtime Environment (build 1.7.0_25-bl5) 

Java HotSpot(TM) 64-Bit Server VM (build 23.25-b01, mixed 
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mode) 


Linux 


java version "1.7.0_25" 

Java(TM) SE Runtime Environment (build 1.7.0_25-bl5) 

Java HotSpot(TM) 64-Bit Server VM (build 23.25-b01, mixed 
mode) 


Mac 


java version "1.7.0_25" 

Java(TM) SE Runtime Environment (build 1.7.0_25-bl5) 

Java HotSpot(TM) 64-Bit Server VM (build 23.25-b01, mixed 
mode) 



If you do not have Java, install the Java Software Development Kit (SDK) from 
http://www.oracle.com/technetwork/java/javase/downloads/index.html. We are 
assuming Java 1.7.0_25 as the installed version for this tutorial. 

Step 2: Set JAVA Environment 



Set the JAVA_HOME environment variable to point to the base directory 
location, where Java is installed on your machine. For example, 



OS 


Output 


Windows 


Set the environment variable JAVA_HOME to C:\Program 
Files\Java\jdkl.7.0_25. 


Linux 


Export JAVA_F10ME=/usr/local/java-current. 


Mac 


Export JAVA_HOME=/Library/Java/Flome. 



Append Java compiler location to System Path. 



OS 


Output 


Windows 


Append the string C:\Program Files\Java\jdkl.7.0_25\bin at 
the end of the system variable, Path. 
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Linux 


Export PATH = $PATH :$JAVA_HOME/bin/ 


Mac 


Not required 



Verify Java Installation using the command java -version as explained above. 

Step 3: Download TestNG Archive 



Download the latest version of TestNG jar file from http://www.testng.org. At 
the time of writing this tutorial, we have downloaded testng-6.8.jar and copied it 
onto C:\>TestNG folder. 



OS 


Archive name 


Windows 


testng-6.8.jar 


Linux 


testng-6.8.jar 


Mac 


testng-6.8.jar 



Step 4: Set TestNG Environment 

Set the TESTNG_HOME environment variable to point to the base directory 
location, where TestNG jar is stored on your machine. The following table shows 
how to set the environment variable in Windows, Linux, and Mac, assuming that 
we've stored testng-6.8.jar at the location C:\>TestNG. 



OS 


Description 


Windows 


Set the environment variable TESTNG_HOME to C:\TESTNG. 


Linux 


Export TESTNG_HOME=/usr/local/TESTNG. 


Mac 


Export TESTNG_HOME=/Library /TESTNG. 
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Step 5: Set CLASSPATH Variable 



Set the CLASSPATH environment variable to point to the TestNG jar location. 



OS 


Description 


Windows 


Set the environment variable CLASSPATH to 
%CLASSPATH%;%TESTNG_HOME%\testng-6.8.jar. 


Linux 


Export CLASSPATH = $CLASSPATH:$TESTNG_HOME/testng- 
6.8.jar. 


Mac 


export CLASSPATH = $CLASSPATH : $TESTNG_HOME/testng- 
6.8.jar. 



Step 6: Test TestNG Setup 



Create a java class file named TestNGSimpleTest at C:\>TestNG_WORKSPACE. 


import org .test ng. annotations .Test; 

import static org. testng. Assert. assertEquals; 




public class TestNGSimpleTest { 

@Test 

public void testAddQ { 

String str = "TestNG is working fine"; 
assertEquals( "TestNG is working fine", 

} 

} 


str); 


TestNG can be invoked in several different ways: 




• With a testng. xml file. 




• With ANT. 




• From the command line. 




Let us invoke using the testng. xml file. Create an xml file with the name 
testng. xml in C:\>TestNG_WORKSPACE to execute Test case(s). 


<?xml version="1.0" encoding="UTF-8" ?> 
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<!DOCTYPE suite SYSTEM "http://testng.Org/testng-l.0.dtd" > 
<suite name="Suitel" > 

<test name="testl" > 

<classes> 

< class name="TestNGSimpleTest"/> 

</classes> 

</test> 

</suite> 



Step 7: Verify the Result 

Compile the class using javac compiler as follows: 

C : \TestNG_WORKSPACE>javac TestNGSimpleTest .java 

Now, invoke the testng.xml to see the result: 

C:\TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng. TestNG 
testng.xml 

Verify the output. 



Suitel 

Total tests run: 1 , Failures: 0 , Skips: 0 
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3. WRITING TESTS 



Writing a test in TestNG basically involves the following steps: 

• Write the business logic of your test and insert TestNG annotations in your 



• Add the information about your test (e.g. the class name, the groups you 
wish to run, etc.) in a testng.xml file or in build. xml. 

• Run TestNG. 

Here, we will see one complete example of TestNG testing using POJO class, 
Business logic class and a test xml, which will be run by TestNG. 

Create EmployeeDetails.java in C:\>TestNG_WORKSPACE, which is a POJO 
class. 

public class EmployeeDetails { 

private String name; 
private double monthlySalary; 
private int age; 



/** 

* @return the name 
*/ 

public String getNameQ { 
return name; 

} 

/** 

* @param name the name to set 
*/ 

public void setName(String name) { 
this. name = name; 

} 

/** 

* @return the monthlySalary 



code. 
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*/ 

public double getMonthlySalary ( ) { 
return monthlySalary; 

} 

I ** 

* @param monthlySalary the monthlySalary to set 

*/ 

public void setMonthlySalary (double monthlySalary) { 
this .monthlySalary = monthlySalary; 

} 

I ** 

* @return the age 
*/ 

public int getAgeQ { 
return age; 

} 

I ** 

* @param age the age to set 

*/ 

public void setAge(int age) { 
this. age = age; 

} 



EmployeeDetails class is used to: 

• get/set the value of employee's name. 

• get/set the value of employee's monthly salary. 

• get/set the value of employee's age. 

Create an EmpBusinessLogic.java in C:\>TestNG_WORKSPACE, which contains 
business logic. 

public class EmpBusinessLogic { 

// Calculate the yearly salary of employee 

public double calculateYearlySalary (EmployeeDetails employeeDetails){ 
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double yeanlySalany=0j 

yeanlySalany = employeeDetails .getMonthlySalaryQ * 12; 
return yearlySalary; 



} 



// Calculate the appraisal amount of employee 

public double calculateAppraisal(EmployeeDetails employeeDetails) { 
double appraisal=0; 

if (employeeDetails .getMonthlySalaryQ < 10000){ 
appraisal = 500; 

}else{ 

appraisal = 1000; 

} 

return appraisal; 



EmpBusinessLogic class is used for calculating: 

• the yearly salary of employee. 

• the appraisal amount of employee. 

Now, let's create a TestNG class called TestEmployeeDetails.java 
in C:\>TestNG_WORKSPACE. A TestNG class is a Java class that contains at 
least one TestNG annotation. This class contains test cases to be tested. A 
TestNG test can be configured by @BeforeXXX and @AfterXXX annotations (we 
will see this in the chapterTestNG - Execution Procedure), which allows to 
perform some Java logic before and after a certain point. 

import org.testng. Assert; 

import org .test ng. annotations .Test; 

public class TestEmployeeDetails { 

EmpBusinessLogic empBusinessLogic = new EmpBusinessLogic () ; 
EmployeeDetails employee = new EmployeeDetails () ; 

@Test 

public void testCalculateAppriasalQ { 



} 



} 
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employee . setName("Rajeev" ) ; 

employee . setAge(25) ; 

employee . setMonthlySalary (8000) ; 

double appraisal = empBusinessLogic . calculateAppraisal(employee) ; 
Assert . assertEquals (500, appraisal, 0.0, "500"); 



// test to check yearly salary 
@Test 

public void testCalculateYearlySalary ( ) { 
employee . setName("Rajeev" ) ; 
employee . setAge(25) ; 
employee . setMonthlySalary (8000) ; 

double salary = empBusinessLogic . calculateYearlySalary (employee) ; 
Assert . assertEquals (96000, salary, 0.0, "8000"); 



TestEmployeeDetails class is used for testing the methods of 
EmpBusinessLogic class. It does the following: 

• Tests the yearly salary of the employee. 

• Tests the appraisal amount of the employee. 

Before you can run the tests, you must configure TestNG using a special XML 
file, conventionally named testng.xml. The syntax for this file is very simple, and 
its contents are as shown below. Create this file in C:\>TestNG_WORKSPACE. 

<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE suite SYSTEM "http://testng.Org/testng-l.0.dtd" > 

<suite name="Suitel" > 

<test name="testl" > 

<classes> 

< class name="TestEmployeeDetails"/> 

</classes> 



} 



} 



} 



</test> 

</suite> 
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Details of the above file are as follows: 

• A suite is represented by one XML file. It can contain one or more tests 
and is defined by the <suite> tag. 

• Tag <test> represents one test and can contain one or more TestNG 
classes. 

• <class> tag represents a TestNG class. It is a Java class that contains at 
least one TestNG annotation. It can contain one or more test methods. 

Compile the Test case classes using javac. 



C : \TestNG_WORKSPACE>javac EmployeeDetails .java EmpBusinessLogic .java 
TestEmployeeDetails .java 



Now TestNG with the following command: 



C:\TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng. TestNG 
testng.xml 



If all has been done correctly, you should see the results of your tests in the 
console. Furthermore, TestNG creates a very nice HTML report in a folder 
called test-output that is automatically created in the current directory. If you 
open it and load index.html, you will see a page similar to the one in the image 
below: 



trsll 
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4. BASIC ANNOTATIONS 



The traditional way to indicate test methods in JUnit 3 is by prefixing their 
names with test. This is a very effective method for tagging certain methods in a 
class as having a special meaning, but the naming doesn't scale very well (what 
if we want to add more tags for different frameworks?) and is rather inflexible 
(what if we want to pass additional parameters to the testing framework?). 

Annotations were formally added to the Java language in JDK 5, and TestNG 
made the choice to use annotations to annotate test classes. 



Here is the list of annotations that TestNG supports: 



Annotation 


Description 


@BeforeSuite 


The annotated method will be run only once before all tests 
in this suite have run. 


@ AfterSuite 


The annotated method will be run only once after all tests 
in this suite have run. 


@BeforeClass 


The annotated method will be run only once before the first 
test method in the current class is invoked. 


@AfterClass 


The annotated method will be run only once after all the 
test methods in the current class have run. 


@BeforeTest 


The annotated method will be run before any test method 
belonging to the classes inside the <test> tag is run. 


@AfterTest 


The annotated method will be run after all the test 
methods belonging to the classes inside the <test> tag 
have run. 


@BeforeG roups 


The list of groups that this configuration method will run 
before. This method is guaranteed to run shortly before the 
first test method that belongs to any of these groups is 
invoked. 


@AfterG roups 


The list of groups that this configuration method will run 
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after. This method is guaranteed to run shortly after the 
last test method that belongs to any of these groups is 
invoked. 


@BeforeMethod 


The annotated method will be run before each test method. 


@AfterMethod 


The annotated method will be run after each test method. 


@DataProvider 


Marks a method as supplying data for a test method. The 
annotated method must return an Object[ ][ ], where each 
Object[ ] can be assigned the parameter list of the test 
method. The @Test method that wants to receive data 
from this DataProvider needs to use a dataProvider name 
equals to the name of this annotation. 


@ Factory 


Marks a method as a factory that returns objects that will 
be used by TestNG as Test classes. The method must 
return Object[ ]. 


©Listeners 


Defines listeners on a test class. 


©Parameters 


Describes how to pass parameters to a @Test method. 


@Test 


Marks a class or a method as a part of the test. 



Benefits of Using Annotations 

Following are some of the benefits of using annotations: 

• TestNG identifies the methods it is interested in by looking up 
annotations. Hence, method names are not restricted to any pattern or 
format. 

• We can pass additional parameters to annotations. 

• Annotations are strongly typed, so the compiler will flag any mistakes 
right away. 

• Test classes no longer need to extend anything (such as TestCase, for 
JUnit 3). 
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5. EXECUTION PROCEDURE 



This chapter explains the execution procedure of methods in TestNG. It explains 
the order of the methods called. Here is the execution procedure of the TestNG 
test API methods with an example. 

Create a java class file name TestngAnnotation.java in 
C:\>TestNG_WORKSPACE to test annotations. 

import org. test ng. annotations .Test; 
import org . testng .annotations . Bef oreMethod; 
import org. testng. annotations .Af terMet hod; 
import org. testng. annotations . BeforeClass; 
import org. testng. annotations . AfterClass; 
import org . testng . annotations . BeforeTest ; 
import org. testng. annotations . AfterTest; 
import org . testng .annotations . BeforeSuite; 
import org. testng. annotations .AfterSuite; 

public class TestngAnnotation { 

// test case 1 
@Test 

public void testCaselQ { 

System. out. println("in test case 1"); 

} 

// test case 2 
@Test 

public void testCase2() { 

System. out. println("in test case 2"); 



} 



@BeforeMethod 

public void beforeMethodQ { 
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System .out . print In ( "in beforeMethod" ) ; 

} 

@AfterMethod 

public void afterMethodQ { 

System. out. println("in afterMethod" ) ; 

} 

@BeforeClass 

public void befoneClass ( ) { 

System .out . print In ( "in beforeClass" ) j 

} 

@AfterClass 

public void afterClassQ { 

System .out . print In ( "in afterClass" ) ; 

} 

@BeforeTest 

public void beforeTestQ { 

System .out . println( "in beforeTest" ) ; 

} 

@AfterTest 

public void afterTest() { 

System .out . println( "in afterTest" ) ; 

} 

@BeforeSuite 

public void beforeSuite( ) { 

System .out . println( "in beforeSuite" ) j 

} 
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@AfterSuite 

public void aftenSuite() { 

System .out . print In ( "in afterSuite" ) ; 

} 

} 

Next, let's create the file testng.xml in C:\>TestNG_WORKSPACE to execute 
annotations. 

<?xml version="1.0" encoding="UTF -8" ?> 

clDOCTYPE suite SYSTEM "http://testng.Org/testng-l.0.dtd" > 

<suite name="Suitel"> 

<test name="testl"> 

<classes> 

< class name="TestngAnnotation"/> 

</classes> 

</test> 

</suite> 

Compile the Test case class using javac. 

C : \TestNG_WORKSPACE> javac TestngAnnotation .java 

Now, run the testng.xml, which will run the test case defined in the provided 
Test Case class. 

C : \TestNG_WORKSPACE>java org.testng. TestNG testng.xml 

Verify the output. 

in beforeSuite 
in beforeTest 
in beforeClass 
in beforeMethod 
in test case 1 
in afterMethod 
in beforeMethod 
in test case 2 
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in afterMethod 
in aftenClass 
in afterTest 
in aftenSuite 



Suite 

Total tests run: 2, Failures: Q, Skips: 0 



Based on the above output, the execution procedure is as follows: 

• First of all, beforeSuite() method is executed only once. 

• Lastly, the afterSuite() method executes only once. 

• Even the methods beforeTest(), beforeClass(), afterClass(), and 
afterTest() methods are executed only once. 

• beforeMethod() method executes for each test case but before executing 
the test case. 

• afterMethod() method executes for each test case but after executing the 
test case. 

• In between beforeMethodQ and afterMethodQ, each test case executes. 
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6. EXECUTING TESTS 



The test cases are executed using TestNG class. This class is the main entry 
point for running tests in the TestNG framework. Users can create their own 
TestNG object and invoke it in many different ways such as: 

• On an existing testng.xml. 

• On a synthetic testng.xml, created entirely from Java. 

• By directly setting the test classes. 

You can also define which groups to include or exclude, assign parameters, etc. 
The command line parameters are: 

• -d outputdir: specify the output directory. 

• -testclass class_name: specifies one or several class names. 

• -testjar jar_name: specifies the jar containing the tests. 

• -sourcedir srcl;src2: ; separated list of source directories (used only 
when javadoc annotations are used). 

• -target 

• -groups 

• -testrunfactory 

• -listener 

We will create the TestNG object an existing testng.xml in our example below. 



Create a Class 



Create a java class to be tested, 
TestNG_WORKSPACE. 


say, MessageUtil.java in C:\> 


/* 




* This class prints the given message on 


console . 


*/ 




public class Messagelltil { 




private String message; 
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//Constructor 

//@param message to be printed 
public MessageUtil(String message){ 
this. message = message; 

} 

// prints the message 
public String printMessage(){ 

System . out . print In (message) ; 
return message; 

} 

} 



Create Test Case Class 

• Create a java test class, say, SampleTest.java. 

• Add a test method testPrintMessage() to your test class. 

• Add an Annotation @Test to method testPrintMessage(). 

• Implement the test condition and check the condition using assertEquals 
API of TestNG. 

Create a java class file called SampleTest.java in C:\> TestNG_WORKSPACE. 

import org.testng. Assert; 

import org .test ng. annotations .Test; 

public class SampleTest { 

String message = "Hello World"; 

Messagelltil messagelltil = new Messagelltil(message) ; 

@Test 

public void testPrintMessage( ) { 

Assert . assertEquals (message, messagelltil . printMessage( ) ) ; 

} 
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} 



Create testng.xml 

Next, let's create testng.xml file in C:\>TestNG_WORKSPACE, to execute test 
case(s). This file captures your entire testing in XML. This file makes it easy to 
describe all your test suites and their parameters in one file, which you can 
check in your code repository or e-mail to coworkers. It also makes it easy to 
extract subsets of your tests or split several runtime configurations (e.g., testng- 
database.xml would run only tests that exercise your database). 

<?xml version="1.0" encoding="UTF-8" ?> 

<suite name="Sample test Suite"> 
ctest name="Sample test"> 

<classes> 

<class name="SampleTest" /> 

</classes> 

</test> 

</suite> 

Compile the test case using javac. 

C : \TestNG_WORKSPACE>javac Messagelltil . java SampleTest . java 

Now, run the testng.xml, which will run the test case defined in <test> tag. 

C:\TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng. TestNG 
testng.xml 

Verify the output. 

Hello World 



Sample test Suite 

Total tests run: 1 , Failures: 0, Skips: 0 
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7. SUITE TEST 



A test suite is a collection of test cases intended to test a behavior or a set of 
behaviors of software program. In TestNG, we cannot define a suite in testing 
source code, but it is represented by one XML file, as suite is the feature of 
execution. It also allows flexible configuration of the tests to be run. A suite can 
contain one or more tests and is defined by the <suite> tag. 

<suite> is the root tag of your testng.xml. It describes a test suite, which in 
turn is made of several <test> sections. 



The following table lists all the legal attributes that <suite> accepts. 



Attribute 


Description 


name 


The name of this suite. It is a mandatory attribute. 


verbose 


The level or verbosity for this run. 


parallel 


Whether TestNG should run different threads to run this suite. 


thread-count 


The number of threads to use, if parallel mode is enabled 
(ignored other-wise). 


annotations 


The type of annotations you are using in your tests. 


time-out 


The default timeout that will be used on all the test methods 
found in this test. 



In this chapter, we will show you an example having two test classes, Testl & 
Test2, to run together using Test Suite. 

Create a Class 

Create a java class to be tested, say, MessageUtil.java in C:\> 
JUNIT_WORKSPACE. 

/* 

* This class prints the given message on console. 
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*/ 

public class Messagelltil { 
private String message; 

// Constructor 

// @param message to be printed 
public Messagelltil(String message) { 
this. message = message; 



// add "Hi!" to the message 
public String salutationMessage( ) { 
message = "Hi!" + message; 

System. out . print In (message) ; 
return message; 



Create Test Case Classes 

Create a java class file named Testl.java in C:\>TestNG_WORKSPACE. 



import org.testng. Assert; 

import org .test ng. annotations .Test; 

public class Testl { 

String message = "Manisha"; 

Messagelltil messagelltil = new Messagelltil(message) ; 



} 



// prints the message 
public String printMessageQ { 
System. out . print In (message) ; 
return message; 

} 



} 



} 
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@Test 

public void testPrintMessage( ) { 

System .out . println( "Inside testPrintl v lessage( ) " ) ; 
Assent . assent Equals (message, messagelltil . printMessage( ) ) ; 
} 



Create a java class file named Test2.java in C:\>TestNG_WORKSPACE. 

impont ong.testng. Assent; 

impont ong.testng. annotations .Test; 

public class Test2 { 

Stning message = "Manisha"; 

Messagelltil messagelltil = new Messagelltil(message) ; 

@Test 

public void testSalutationMessage( ) { 

System .out . pnintln( "Inside testSalutationMessage( ) " ) ; 
message = "Hi!" + "Manisha"; 

Assent . assent Equals (message, messagelltil . salutationMessage( ) ) ; 

} 

} 

Now, let's write the testng.xml in C:\>TestNG_WORKSPACE, which would contain 
the <suite> tag as follows: 

<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE suite SYSTEM "http : //testng . ong/testng-1 . 0 . dtd" > 

<suite name="Suitel" > 

<test name="exampletestl"> 

<classes> 

<class name="Testl" /> 

</classes> 

</test> 

<test name="exampletest2"> 
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<classes> 

<class name="Test2" /> 

</classes> 

</test> 

</suite> 

Suitel includes exampletestl and exampletest2. 

Compile all java classes using javac. 

C : \TestNG_WORKSPACE>javac Messagelltil . java Testl.java Test2.java 

Now, run the testng.xml, which will run the test case defined in the provided 
Test Case class. 



C:\TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng. TestNG 
testng.xml 

Verify the output. 

Inside testPrintMessageQ 
Manisha 

Inside testSalutationMessageQ 
Hi ! Manisha 



Suitel 

Total tests run: 2, Failures: 0 , Skips: 0 



You can also check the test-output folder. Under the Suitel folder, you can see 
two html files created, exampletestl.html and exampletest2.html, which would 
look as follows: 
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8. IGNORE A TEST 



Sometimes, it happens that our code is not ready and the test case written to 
test that method/code fails. In such cases, annotation @Test(enabled = 
false) helps to disable this test case. 

If a test method is annotated with @Test(enabled = false), then the test case 
that is not ready to test is bypassed. 

Now, let's see @Test(enabled = false) in action. 

Create a Class 

Create a java class to be tested, say, MessageUtil.java in C:\> 
TestNG_WORKSPACE. 

/* 

* This class prints the given message on console. 

*/ 

public class Messagelltil { 
private String message; 

//Constructor 

//@param message to be printed 
public MessageUtil(String message){ 
this. message = message; 



} 



// prints the message 



public String printMessage(){ 
System. out . print In (message) ; 
return message; 



} 



// add "Hi!" to the message 
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public String salutationl v lessage(){ 
message = "Hi!" + message; 
System. out . print In (message) ; 
return message; 

} 

} 



Create Test Case Class 

• Create a java test class, say, IgnoreTest.java. 

• Add test methods, testPrintMessage() and testSalutationMessage(), to 
your test class. 

• Add an Annotation @Test(enabled = false) to the method 
testPrintMessage(). 

Create a java class file named IgnoreTest.java in C:\>TestNG_WORKSPACE. 

import org.testng. Assert; 

import org .test ng. annotations .Test; 

public class IgnoreTest { 

String message = "Manisha"; 

Messagelltil messagelltil = new Messagelltil(message) ; 

@Test (enabled = false) 

public void testPrintMessage( ) { 

System .out . println( "Inside testPrintMessage( ) " ) ; 
message = "Manisha"; 

Assert . assert Equals (message, messagelltil . printMessage( ) ) ; 

} 

@Test 

public void testSalutationMessage( ) { 

System .out . println( "Inside testSalutationl v lessage( ) " ) ; 
message = "Hi!" + "Manisha"; 

Assert . assert Equals (message, messagelltil . salutationMessage( ) ) ; 
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Create testng.xml 

Create testng.xml in C:\>TestNG_WORKSPACE to execute test case(s). 

<?xml version="1.0" encoding="UTF-8" ?>< IDOCTYPE suite SYSTEM 
"http://testng.Org/testng-l.0.dtd" > 

<suite name="Suitel" > 

<test name="testl" > 

<classes> 

<class name="IgnoreTest" /> 

</classes> 

</test> 

</suite> 

Compile the Messagelltil and test case classes using javac. 

C : \TestNG_WORKSPACE>javac Messagelltil . java IgnoreTest . java 

Now, run the testng.xml, which will not run testPrintMessage() the test case 
defined in provided the Test Case class. 



C:\TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng. TestNG 
testng.xml 

Verify the output. testPrintMessage() test case is not tested. 

Inside testSalutationMessageQ 
Hi ! Manisha 



Suitel 

Total tests run: 1 , Failures: 0 , Skips: 0 



You can also ignore a group of tests, which will be discussed in the next chapter. 
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9. GROUP TEST 



Group test is a new innovative feature in TestNG, which doesn't exist in JUnit 
framework. It permits you to dispatch methods into proper portions and perform 
sophisticated groupings of test methods. 

Not only can you declare those methods that belong to groups, but you can also 
specify groups that contain other groups. Then, TestNG can be invoked and 
asked to include a certain set of groups (or regular expressions), while excluding 
another set. 

Group tests provide maximum flexibility in how you partition your tests, and 
doesn't require you to recompile anything if you want to run two different sets of 
tests back to back. 

Groups are specified in your testng.xml file using the <groups> tag. It can be 
found either under the <test> or <suite> tag. Groups specified in the <suite> 
tag apply to all the <test> tags underneath. 

Now, let's take an example to see how group test works. 

Create a Class 

Create a java class to be tested, say, MessageUtil.java in C:\> 
TestNG_WORKSPACE. 

/* 

* This class prints the given message on console. 

*/ 

public class Messagelltil { 
private String message; 

// Constructor 

// @param message to be printed 
public MessageUtil(String message) { 



this. message = message; 



} 



// prints the message 
public String printMessage( ) { 
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System. out . print In (mess age) ; 
return message; 



} 



// add "tutorialspoint" to the message 
public String salutationMessageQ { 

message = "tutorialspoint" + message; 
System .out . print In (message ) ; 
return message; 



// add "www." to the message 
public String exitMessage( ) { 
message = "www." + message; 
System .out . print In (message) ; 
return message; 

} 

} 



Create Test Case Class 

• Create a java test class, say, GroupTestExample.java. 

• Add test methods, testPrintMessage() and testSalutationMessage(), to 
your test class. 

• Group the test method in two categories: 

o Check-in tests (checkintest): These tests should be run before you 
submit new code. They should typically be fast and just make sure no 
basic functionality is broken. 

o Functional tests (functest): These tests should cover all the 
functionalities of your software and be run at least once a day, 
although ideally you would want to run them continuously. 

Create the java class file named GroupTestExample.java in C:\> 
TestNG WORKSPACE. 



} 
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import org.testng. Assert; 

import org .test ng. annotations .Test; 

public class GroupTestExample { 

String message = ".com"; 

Messagelltil messagelltil = new Messagelltil(message) ; 

@Test (groups = { "functest", "checkintest" }) 
public void testPrintMessage( ) { 

System .out . println( "Inside test PrintMes sage ( ) " ) ; 
message = " . com" ; 

Assert . assert Equals (message, messagelltil . printMessage( ) ) ; 

} 

@Test (groups = { "checkintest" }) 
public void testSalutationMessage( ) { 

System .out . println( "Inside testSalutationMessage( ) " ) ; 
message = "tutorialspoint" + ".com"; 

Assert . assert Equals (message , messagelltil . salutationMessage( ) ) ; 

} 

@Test (groups = { "functest" }) 
public void testingExitMessageQ { 

System .out . println( "Inside test ExitMes sage ( ) " ) ; 
message = "www." + "tutorialspoint"+" . com" ; 

Assert . assert Equals (message , messagelltil . exitMessage( ) ) ; 



} 

} 



Create testng.xml 

Create testng.xml in C:\>TestNG_WORKSPACE to execute test case(s). Here, we 
would be executing only those tests that belong to the group functest. 
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<?xml vension="1.0" encoding="UTF-8" ?> 

<!DOCTYPE suite SYSTEM "http://testng.Org/testng-l.0.dtd" > 

<suite name="Suitel" > 

<test name="testl"> 

<groups> 

<run> 

<include name="functest" /> 

</run> 

</groups> 

<classes> 

<class name="GroupTestExample" /> 

</classes> 

</test> 

</suite> 

Compile the Messagelltil, Test case classes using javac. 

C : \TestNG_WORKSPACE> javac Messagelltil .java GroupTest Example .java 

Now, run the testng.xml, which will run only the method testPrintMessage(), as 
it belongs to the group functest. 



C:\TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng. TestNG 
testng.xml 

Verify the output. Only the method testPrintMessage() is executed. 

Inside testPrintMessage( ) 

. com 

Inside testExitMessage( ) 
www. . com 



Suitel 

Total tests run: 2, Failures: 1, Skips: 0 
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Group of Groups 

Groups can also include other groups. These groups are called MetaGroups. For 
example, you might want to define a group all that includes checkintest and 
functest. Let's modify our testng.xml file as follows: 

<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE suite SYSTEM "http://testng.Org/testng-l.0.dtd" > 

<suite name="Suitel"> 
ctest name="testl"> 

<groups> 

<define name="all"> 

<include name="f unctest"/> 

<include name="checkintest"/> 

</def ine> 

<run> 

<include name="all"/> 

</run> 

</groups> 

<classes> 

<class name="GroupTestExample" /> 

</classes> 

</test> 

</suite> 

Executing the above testng.xml will execute all the three tests and will give you 
the following result: 

Inside testPrintMessage( ) 

. com 

Inside testSalutationMessageQ 
tutorials point . com 
Inside testExitMessage( ) 
www.tutorialspoint . com 



Suitel 
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Total tests run: 3 , Failures: Q, Skips: 0 



Exclusion Groups 

You can ignore a group by using the <exclude> tag as shown below: 

<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE suite SYSTEM "http://testng.Org/testng-l.0.dtd" > 
<suite name="Suitel" > 

<test name="testl" > 

<groups> 

<define name="all"> 

<exclude name="functest"/> 

<include name="checkintest"/> 

</def ine> 

<run> 

<include name="all"/> 

</run> 

</groups> 

<classes> 

cclass name="GroupTestExample" /> 

</classes> 

</test> 

</suite> 
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10. EXCEPTION TEST 



TestNG provides an option of tracing the exception handling of code. You can 
test whether a code throws a desired exception or not. Here the 
expected Exceptions parameter is used along with the @Test annotation. Now, 
let's see @Test(expectedExceptions) in action. 



Create a java class to be tested, say, MessageUtil.java in C:\> 
TestNG_WORKSPACE. Add an error condition inside the printMessage() 
method. 

/* 

* This class prints the given message on console. 

*/ 

public class Messagelltil { 
private String message; 

//Constructor 

//@param message to be printed 
public MessageUtil(String message){ 
this. message = message; 



// prints the message 
public void printMessage( ){ 
System. out . print In (message) ; 
int a =0; 
int b = 1/a; 



Create a Class 



} 



> 



// add "Hi!" to the message 
public String salutationMessage(){ 
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message = "Hi!" + message; 
System . out . print In (message) ; 
return message; 

} 

} 



Create Test Case Class 

• Create a java test class, say, ExpectedExceptionTest.java. 

• Add an expected exception ArithmeticException to the testPrintMessage() 
test case. 

Create a java class file named ExpectedExceptionTest.java in 
C : \>TestNG_WORKSPACE. 

import org.testng. Assert; 

import org .test ng. annotations .Test; 

public class ExpectedExceptionTest { 

String message = "Manisha"; 

Messagelltil messagelltil = new Messagelltil(message) ; 

@Test(expectedExceptions = ArithmeticException . class) 
public void testPrintMessage( ) { 

System .out . println( "Inside testPrintMessage( ) " ) ; 
messagelltil . printMessage( ) ; 

} 

@Test 

public void testSalutationMessage( ) { 

System. out . println( "Inside testSalutationMessage( ) " ) ; 
message = "Hi!" + "Manisha"; 

Assert . assert Equals (message , messagelltil . salutationMessageQ ) ; 

} 

} 
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Create Test Runner 

Create testng.xml in C:\>TestNG_WORKSPACE to execute test case(s). 

<?xml version="1.0" encoding="UTF-8" ?> 

<!DOCTYPE suite SYSTEM "http://testng.Org/testng-l.0.dtd" > 

<suite name="Suitel" > 
ctest name="testl" > 

<classes> 

<class name="ExpectedExceptionTest" /> 

</classes> 

</test> 

</suite> 

Compile the Messagelltil, Test case classes using javac. 

C : \TestNG_WORKSPACE>javac Messagelltil . java TestDunit . java 

Now, run the Test Runner, which will run test cases defined in the provided Test 
Case class. 



C:\TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng. TestNG 
testng.xml 

Verify the output. testPrintMessage() test case will be passed. 

Inside testPrintMessageQ 
Manisha 

Inside testSalutationMessageQ 
Hi ! Manisha 



Suitel 

Total tests run: 2, Failures: Q, Skips: 0 
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11. DEPENDENCY TEST 



Sometimes, you may need to invoke methods in a test case in a particular order, 
or you may want to share some data and state between methods. This kind of 
dependency is supported by TestNG, as it supports the declaration of explicit 
dependencies between test methods. 

TestNG allows you to specify dependencies either with: 

• Using attribute dependsOnMethods in @Test annotations, OR 

• Using attribute dependsOnGroups in @Test annotations. 

Example Using dependsOnMethods 

Create a Class 

Create a java class to be tested, say, MessageUtil.java in 
C:\>TestNG_WORKSPACE. 

public class Messagelltil { 
private String message; 

// Constructor 

// @param message to be printed 
public MessageUtil(String message) { 



// prints the message 
public String printMessage( ) { 
System. out . print In (message) ; 
return message; 

} 

// add "Hi!" to the message 
public String salutationMessage( ) { 
message = "Hi!" + message; 



this. message = message; 



} 
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System. out . print In (message ) ; 
return message; 

} 



Create Test Case Class 

• Create a java test class, say, DependencyTestUsingAnnotation.java. 

• Add test methods, testPrintMessage() and testSalutationMessage(), and 
initEnvironmentTest() to your test class. 

• Add attribute dependsOnMethods = {"initEnvironmentTest"} to the 
@Test annotation of testSalutationMessage() method. 

Create a java class file named DependencyTestUsingAnnotation.java in 

C:\>TestNG_WORKSPACE. 

import org.testng. Assert; 

import org .test ng. annotations .Test; 

public class DependencyTestUsingAnnotation { 

String message = "Manisha"; 

Messagelltil messagelltil = new Messagelltil(message) ; 

@Test 

public void testPrintMessage( ) { 

System . out . print In ( "Inside test PrintMes sage ( ) " ) ; 
message = "Manisha"; 

Assert . assert Equals (message , messagelltil . printMessage( ) ) ; 

} 

@Test (dependsOnMethods = { "initEnvironmentTest" }) 
public void testSalutationMessage( ) { 

System .out . println( "Inside testSalutationMessage( ) " ) ; 
message = "Hi!" + "Manisha"; 

Assert . assert Equals (message , messagelltil . salutationMessage( ) ) ; 

} 
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@Test 

public void initEnvironmentTest() { 

System. out. println("This is initEnvironmentTest"); 

} 



Create testng.xml 

Create testng.xml in C:\>TestNG_WORKSPACE to execute test case(s). 

<?xml version="1.0" encoding="UTF-8" ?>< ! DOCTYPE suite SYSTEM 
"http://testng.Org/testng-l.0.dtd" > 

<suite name="Suitel" > 

<test name="testl"> 

<classes> 

<class name="DependencyTestl)singAnnotation" /> 
</classes> 

</test> 

</suite> 

Compile the Messagelltil, Test case classes using javac. 

C : \TestNG_WORKSPACE>javac Messagelltil . java 
DependencyTestUsingAnnotation .java 



Now, run the testng.xml, which will run the testSalutationMessage() method only 
after the execution of initEnvironmentTestQ method. 



C:\TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng. TestNG 
testng.xml 

Verify the output. 

This is initEnvironmentTest 
Inside testPrintMessage( ) 

Manisha 

Inside testSalutationMessageQ 
Hi ! Manisha 
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Suitel 

Total tests run: 3 , Failures: 0, Skips: 0 



Example Using dependsOnGmups 

You can also have methods that depend on entire groups. Let's have an example 
to demonstrate this. 

Create a Class 

Create a java class to be tested, say, MessageUtil.java in C:\> 
TestNG_WORKSPACE. 

public class Messagelltil { 
private String message; 

// Constructor 

// @param message to be printed 
public MessageUtil(String message) { 
this. message = message; 

} 

// prints the message 
public String printMessage( ) { 

System. out . print In (message) ; 
return message; 

} 

// add "Hi!" to the message 
public String salutationMessageQ { 
message = "Hi!" + message; 

System .out . print In (message ) ; 
return message; 

} 
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} 



Create Test Case Class 

• Create a java test class, say, DependencyTestUsingAnnotation.java. 

• Add test methods, testPrintMessage(), testSalutationMessage(), and 
initEnvironmentTest() to your test class, and add them to the group "init". 

• Add the attribute dependsOnMethods = {"init.*"} to the @Test 
annotation oftestSalutationMessage() method. 

Create a java class file named DependencyTestUsingAnnotation.java in 

C : \>TestNG_WORKSPACE. 

import org.testng. Assert; 

import org.testng. annotations .Test; 

public class DependencyTestUsingAnnotation { 

String message = "Manisha"; 

Messagelltil messagelltil = new Messagelltil(message) ; 

@Test (groups = { "init" }) 
public void testPrintMessage( ) { 

System .out . println( "Inside test PrintMes sage ( ) " ) ; 
message = "Manisha"; 

Assert . assert Equals (message , messagelltil . printMessage( ) ) ; 

} 

@Test(dependsOnGroups = { "init.*" }) 
public void testSalutationMessage( ) { 

System .out . println( "Inside testSalutationMessage( ) " ) ; 
message = "Hi!" + "Manisha"; 

Assert . assert Equals (message , messagelltil . salutationMessage( ) ) ; 

} 

@Test (groups = { "init" }) 
public void initEnvironmentTestQ { 
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System. out. pnintln("This is initEnvironmentTest"); 

} 

} 

In this example, testSalutationMessage() is declared as depending on any group, 
matching the regular expression "init.*", which guarantees that the methods 
testPrintMessage() and initEnvironmentTest() will always be invoked before 
testSalutationMessage(). 

If a method depended upon fails, and you have a hard dependency on it 
(alwaysRun=false, which is the default), the methods that depend on it are not 
marked as FAIL but as SKIP. Skipped methods will be reported as such in the 
final report (in a color that is neither Red nor Green in HTML), which is important 
since skipped methods are not necessarily failures. 

Create testng.xml 

Create testng.xml in C:\>TestNG_WORKSPACE to execute test case(s). 

<?xml version="1.0" encoding="UTF-8" ?>< IDOCTYPE suite SYSTEM 
"http://testng.Org/testng-l.0.dtd" > 

<suite name="Suitel" > 

ctest name="testl"> 

<classes> 

<class name="DependencyTestUsingAnnotation" /> 

</classes> 

</test> 

</suite> 



Compile the MessageUtil, Test case classes using javac. 



C : \TestNG_WORKSPACE>javac MessageUtil . java 
DependencyTestUsingAn notation .java 



Now, run the testng.xml, which will run the testSalutationMessage() method only 
after the execution of initEnvironmentTestQ method. 



C:\TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng. TestNG 
testng.xml 



Verify the output. 



This is initEnvironmentTest 
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Inside testPrintMessageQ 
Manisha 

Inside testSalutationMessageQ 
Hi ! Manisha 



Suitel 

Total tests run: 3 , Failures: 0, Skips: 0 



dependsOnGroups Vs dependsOnMethods 

• On using groups, we are no longer exposed to refactoring problems. As 
long as we don't modify the dependsOnGroups or groups attributes, our 
tests will keep running with the proper dependencies set up. 

• Whenever a new method needs to be added in the dependency graph, all 
we need to do is put it in the right group and make sure it depends on the 
correct group. We don't need to modify any other method. 
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12. PARAMETERIZED TEST 



Another interesting feature available in TestNG is parametric testing. In most 
cases, you'll come across a scenario where the business logic requires a hugely 
varying number of tests. Parameterized tests allow developers to run the 
same test over and over again using different values. 

TestNG lets you pass parameters directly to your test methods in two different 
ways: 

• With testng.xml 

• With Data Providers 



Passing Parameters with testng.xml 

With this technique, you define the simple parameters in the testng.xml file and 
then reference those parameters in the source files. Let us have an example to 
demonstrate how to use this technique to pass parameters. 



Create Test Case Class 

• Create a java test class, say, ParameterizedTestl.java. 

• Add test method parameterTest() to your test class. This method takes a 
string as input parameter. 

• Add the annotation @Parameters("myName") to this method. The 
parameter would be passed a value from testng.xml, which we will see in 
the next step. 



Create a java class file named ParameterizedTestl.java in 
C : \>TestNG_WORKSPACE. 



import org .test ng. annotations . Parameters; 
import org .test ng. annotations .Test; 

public class ParameterizedTestl { 

@Test 

@Parameters ( "myName" ) 

public void parameterTest(String myName) { 

System. out. println("Parameterized value is : " + myName); 

} 

46 
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} 



Create testng.xml 

Create testng.xml in C:\>TestNG_WORKSPACE to execute test case(s). 

<?xml version="1.0" encoding="UTF-8" ?>< IDOCTYPE suite SYSTEM 
"http://testng.Org/testng-l.0.dtd" > 

<suite name="Suitel" > 

ctest name="testl"> 

<parameter name="myName" value="manisha"/> 

<classes> 

<class name="ParameterizedTestl" /> 

</classes> 

</test> 

</suite> 

We can also define the parameters at the <suite> level. Suppose we have 
defined myName at both <suite> and <test> levels. In such cases, regular 
scoping rules apply. It means that any class inside <test> tag will see the value 
of parameter defined in <test>, while the classes in the rest of the testng.xml 
file will see the value defined in <suite>. 

Compile the test case class using javac. 

C : \TestNG_WORKSPACE>javac ParameterizedTestl .java 

Now, run testng.xml, which will run the parameterTest method. TestNG will try 
to find a parameter named myName first in the <test> tag, and then, if it can't 
find it, it searches in the <suit> tag that encloses it. 



C:\TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng. TestNG 
testng.xml 

Verify the output. 

Parameterized value is : manisha 



Suitel 

Total tests run: 1 , Failures: 0, Skips: 0 
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TestNG will automatically try to convert the value specified in testng.xml to the 
type of your parameter. Here are the types supported: 

• String 

• int/Integer 

• boolean/Boolean 

• byte/ Byte 

• char/Character 

• double/Double 

• float/Float 

• long/Long 

• short/Short 

Passing Parameters with Dataproviders 

When you need to pass complex parameters or parameters that need to be 
created from Java (complex objects, objects read from a property file or a 
database, etc.), parameters can be passed using Dataproviders. 

A Data Provider is a method annotated with @DataProvider. This annotation has 
only one string attribute: its name. If the name is not supplied, the data 
provider's name automatically defaults to the method's name. A data provider 
returns an array of objects. 

The following examples demonstrate how to use data providers. The first 
example is about @DataProvider using Vector, String, or Integer as parameter, 
and the second example is about @DataProvider using object as parameter. 

Example 1 

Here, the @DataProvider passes Integer and Boolean as parameter. 

Create Java class 

Create a java class called PrimeNumberChecker.java. This class checks if the 
number is prime. Create this class in C:\>TestNG_WORKSPACE. 

public class PrimeNumberChecker { 

public Boolean validate(f inal Integer primeNumber) { 
for (int i = 2; i < (primeNumber / 2); i++) { 
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if (primeNumben % i == 0) { 
return false; 

} 

} 

return true; 

} 

} 



Create Test Case Class 

• Create a java test class, say, ParamTestWithDataProviderl.java. 

• Define the method primeNumbers(), which is defined as a Dataprovider 
using the annotation. This method returns an array of objects. 

• Add the test method testPrimeNumberChecker() to your test class. This 
method takes an Integer and Boolean as input parameters. This method 
validates if the parameter passed is a prime number. 

• Add the annotation @Test(dataProvider = "testl")to this method. The 
attribute dataProvider is mapped to "testl". 

Create a java class file named ParamTestWithDataProviderl.java 

in C:\>TestNG_WORKSPACE. 

import org.testng. Assert; 
import org .test ng. annotations . BeforeMethod; 
import org .test ng. annotations .DataProvider; 
import org .test ng. annotations .Test; 

public class ParamTestWithDataProviderl { 

private PrimeNumberChecker primeNumberChecker; 

@BeforeMethod 

public void initializeQ { 

primeNumberChecker = new PrimeNumberChecker () ; 

} 

@DataProvider(name = "testl") 

public static Object[][] primeNumbers ( ) { 
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return new Object[][] { { 2 , true }, { 6 , false }, { 19 , true }, 
{ 22 , false }, { 23 , true } }; 

} 

// This test will run 4 times since we have 5 parameters defined 
@Test(dataProvider = "testl") 

public void testPrimeNumberChecker(Integer inputNumber, 

Boolean expectedResult) { 

System. out. println(inputl\lumber + " " + expectedResult); 

Assert . assert Equals (expectedResult , 

primeNumberChecker .validate (in putNumber) ) ; 

} 



Create testng.xml 

Create a testng.xml C:\ > TestNG_WORKSPACE to execute Test case(s). 

<?xml version="1.0" encoding="UTF-8" ?>< ! DOCTYPE suite SYSTEM 
"http://testng.Org/testng-l.0.dtd" > 

<suite name="Suitel" > 

ctest name="testl"> 

<classes> 

<class name="ParamTestWithDataProviderl" /> 

</classes> 

</test> 

</suite> 

Compile the Test case class using javac. 

C : \TestNG_WORKSPACE> . javac ParamTestWithDataProviderl .java 
PrimeNumberChecker .java 

Now, run testng.xml. 

C : \TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng. TestNG 
testng.xml 

Verify the output. 
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2 true 
6 false 
19 true 

22 false 

23 true 



Suitel 

Total tests run: 5, Failures: 0 , Skips: 0 



Example 2 

Here, the @DataProvider passes Object as parameter. 

Create Java class 

Create a java class Bean.java, which is a simple object with get/set methods, 
in C:\>TestNG_WORKSPACE. 

public class Bean { 

private String val; 
private int i; 

public Bean(String val, int i){ 



this . val=val; 
this . i=i; 



} 



public String getValQ { 
return val; 



} 



public void setVal(String val) { 
this. val = val; 



} 



public int getl() { 
return i; 



} 

public void setl(int i) { 
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this.i = i; 

} 

} 

Create Test Case Class 

• Create a java test class, say, ParamTestWithDataProvider2.java. 

• Define the method primeNumbers(), which is defined as a data provider 
using annotation. This method returns an array of objects. 

• Add the test method testMethod() to your test class. This method takes 
an object bean as parameter. 

• Add the annotation @Test(dataProvider = "testl") to this method. The 
attribute dataProvider is mapped to "testl". 

Create a java class file named ParamTestWithDataProvider2.java in 

C:\>TestNG_WORKSPACE. 

import org .test ng. annotations .DataProvider; 
import org .test ng. annotations .Test; 

public class ParamTestWithDataProvider2 { 

@DataProvider(name = "testl") 

public static Object[][] primeNumbers ( ) { 

return new Object[][] { { new Bean("hi I am the bean". 111) } }; 

} 

@Test (dataProvider = "testl") 
public void testMethod(Bean myBean) { 

System. out. println(myBean.getVal() + " " + myBean.getlQ); 

} 



Create testng.xml 

Create testng.xml in C:\>TestNG_WORKSPACE to execute test case(s). 



<?xml version="1.0" encoding="UTF-8" ?>< ! DOCTYPE suite SYSTEM 
"http://testng.Org/testng-l.0.dtd" > 




tutorialspoint 



52 



TestNG 



<suite name="Suitel" > 

<test name="testl"> 

<classes> 

<class name="ParamTestWithDataProvider2" /> 

</classes> 

</test> 

</suite> 

Compile the test case class using javac. 

C : \TestNG_WORKSPACE>javac ParamTestWithDataProvider2 .java Bean .java 

Now, run testng.xml. 

C:\TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng. TestNG 
testng.xml 

Verify the output. 

hi I am the bean 111 



Suitel 

Total tests run: 1, Failures: Q, Skips: 0 
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Now that you have understood TestNG and its various tests, you must be 
worried by now as to how to refactor your existing JUnit code. There's no need 
to worry, as TestNG provides a way to shift from JUnit to TestNG at your own 
pace. You can execute your existing JUnit test cases using TestNG. 

TestNG can automatically recognize and run JUnit tests, so that you can use 
TestNG as a runner for all your existing tests and write new tests using TestNG. 
All you have to do is to put JUnit library on the TestNG classpath, so it can find 
and use JUnit classes, change your test runner from JUnit to TestNG in Ant, and 
then run TestNG in "mixed" mode. This way, you can have all your tests in the 
same project, even in the same package, and start using TestNG. This approach 
also allows you to convert your existing JUnit tests to TestNG incrementally. 

Let us have an example to demonstrate this amazing ability of TestNG. 



Create JUnit Test Case Class 



Create a java class, which is a JUnit test class, TestJunit.java in 
C:\>TestNG_WORKSPACE. 

import org. junit. Test; 

import static org.testng.AssertJUnit.assertEquals; 

public class TestJunit { 

@Test 

public void testAddQ { 

String str= "Junit testing using TestNG"; 
assertEquals ( "Junit testing using TestNG" , str) ; 

} 

} 

Now, let's write the testng.xml in C:\>TestNG_WORKSPACE, which would contain 
the <suite> tag as follows: 

<?xml version="1.0" encoding="UTF-8" ?> 

clDOCTYPE suite SYSTEM "http://testng.Org/testng-l.0.dtd"> 

<suite name="Converted JUnit suite" > 

54 
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<test name="DUnitTests" junit="tnue"> 

<classes> 

<class name="TestDunit" /> 

</classes> 

</test> 

</suite> 

To execute the JUnit test cases, define the property junit-"true " as in the xml 
above. The JUnit test case class TestJunit is defined in class name. 

For JUnit 4, TestNG will use the org.junit. runner. JUnitCore runner to run your 
tests. 

Compile all java classes using javac. 

C : \TestNG_WORKSPACE> javac Test Junit . java 
Now, run testng.xml, which will run the JUnit test case as TestNG. 
C:\TestNG_WORKSPACE>java -cp 

"C : \TestNG_WORKSPACE : C : \TestNG_WORKSPACE\lib\ junit-4. 11 . jar" 
org.testng. TestNG testng.xml 

Here, we have placed the junit-4. ll.jar underC:\TestNG_WORKSPACE\lib\junit- 
4.11.jar. 

Verify the output. 



Converted JUnit suite 

Total tests run: 1 , Failures: 0, Skips: 0 
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Reporting is the most important part of any test execution, as it helps the user 
understand the result of the test execution, point of failure, and the reasons for 
failure. Logging, on the other hand, is important to keep an eye on the execution 
flow or for debugging in case of any failures. 

TestNG, by default, generates a different type of report for its test execution. 
This includes an HTML and an XML report output. TestNG also allows its users to 
write their own reporter and use it with TestNG. There is also an option to write 
your own loggers, which are notified at runtime by TestNG. 

There are two ways to generate a report with TestNG: 

• Listeners: For implementing a listener class, the class has to implement 
the org.testng.ITestListener interface. These classes are notified at 
runtime by TestNG when the test starts, finishes, fails, skips, or passes. 

• Reporters: For implementing a reporting class, the class has to 
implement an org.testng.IReporter interface. These classes are called 
when the whole suite run ends. The object containing the information of 
the whole test run is passed to this class when called. 



In this chapter, we will have four different examples to demonstrate four 
different cases of reporting and logging: 



Custom Logging 


This example illustrates how to write your own logger. 


Custom 

Reporter 


This example illustrates how to write your own reporter. 


HTML and XML 
report 


This example illustrates the default HTML and XML report 
generated by TestNG. 


JUnit Reports 


This example illustrates how to generate JUnit reports from 
TestNG reports. 



Custom Logging 

We had earlier read about the different options that TestNG provides for logging 
and reporting. Now, let's learn how to start using them. To start with, we will 
write a sample program in which we will use the ITestListener interface for 
logging purposes. 
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Create Test Case Class 

Create a java class, say, SampleTest.java in C:\>TestNG_WORKSPACE. 

import org.testng. Assert; 

import org .test ng. annotations .Test; 

public class SampleTest { 

@Test 

public void testMethodOne(){ 

Assert .assertTrue (true) ; 

} 

@Test 

public void testMethodTwo(){ 

Assert . assertTrue (false ) ; 

} 

@Test ( depend sOnMet hods ={ "testMethodTwo" }) 
public void testMethodThree(){ 

Assert .assertTrue (true) ; 

} 

} 

The preceding test class contains three test methods out of 
which testMethodOne and testMethodThree will pass when executed, whereas 
testMethodTwo is made to fail by passing a false Boolean value to the 
Assert. assertTrue method, which is used for truth conditions in the tests. 



Create Custom Logging Class 

Create another new class named CustomListener.java in C:\> 
Test NG_WORKS PACE. 

import org.testng. ITestResult; 
import org .test ng. Test List enerAdapter; 

public class CustomListener extends TestListenerAdapter{ 
private int m_count = 0; 

57 
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@Override 

public void onTestFailune(ITestResult tr) { 

log(tn.getName( )+ "--Test method failed\n"); 

} 

@Override 

public void onTestSkipped(ITestResult tr) { 

log(tn.getName( )+ "--Test method skipped\n")j 

} 

@Override 

public void onTestSuccess (ITestResult tr) { 

log(tr .getName( )+ "--Test method success\n"); 

} 

private void log(String string) { 

System .out . print (string) ; 
if (++m_count % 40 == 0) { 

System . out . print In ( " " ) ; 

} 



The above class extends TestListenerAdapter, which implements 
ITestListener with empty methods. Hence, no need to override other methods 
from the interface. You can implement the interface directly, if you prefer so. 

Create testng.xml 

Create testng.xml in C:\>TestNG_WORKSPACE to execute test case(s). 

<?xml version="1.0" encoding="UTF-8" ?> 

<suite name="Simple Logger Suite" > 

<listeners> 

clistener class-name="CustomListener" /> 



} 



} 
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</listenens> 

<test name="Simple Logger test"> 

<classes> 

<class name="SampleTest" /> 

</classes> 

</test> 

</suite> 

Compile the SampleTest, CustomListener classes using javac. 

C : \TestNG_WORKSPACE>javac CustomListener . java SampleTest . java 
Now, run the testng.xml. 

C : \TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng. TestNG 
testng.xml 

Verify the output. 

testMethodOne- -Test method success 
testMethodTwo- -Test method failed 
testMethodThree- -Test method skipped 



Simple Logger Suite 

Total tests run: 3 , Failures: 1 , Skips: 1 



We created a custom logger class, which implements the ITestListener interface 
and attached itself to the TestNG test suite as a listener. Methods of this listener 
class are invoked by TestNG when test started, at test fail, at test success, and 
so on. Multiple listeners can be implemented and added to the test suite 
execution, TestNG will invoke all the listeners that are attached to the test suite. 

Logging listeners are mainly used when we need to see the continuous status of 
the test execution when the tests are getting executed. 
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Custom Reporter 



In this section, we will cover, with an example, the method of writing your 
custom reporter and attaching it to TestNG. To write a custom reporter class, 
our extension class should implement the IReporter interface. Let's go ahead 
and create an example with the custom reporter. 



Create Test Case Class 

Create a java class, say, SampleTest.java in C:\>TestNG_WORKSPACE. 



import org.testng. Assert; 

import org .test ng. annotations .Test; 

public class SampleTest { 

@Test 

public void testMethodOne(){ 

Assert . assertTrue(true) ; 

} 

@Test 

public void testMethodTwo(){ 

Assert . assertTrue(false) ; 

} 

@Test ( depend sOnMet hods ={ "testMethodTwo" }) 
public void testMethodThree(){ 

Assert . assertTrue(true) ; 



The preceding test class contains three test methods out of which 
testMethodOne and testMethodThree will pass when executed, whereas 
testMethodTwo is made to fail by passing a false Boolean value to the 
Assert. assertTrue method, which is used for truth conditions in the tests. 

Create Custom Reporting Class 

Create another new class named CustomReporter.java in 
C : \>TestNG_WORKSPACE. 



} 



} 
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import java . util . List; 
import java . util .Map; 

import org.testng. IReporter; 
import org.testng. ISuite; 
import org.testng. ISuiteResult; 
import org.testng. ITestContext; 
import org.testng. xml. XmlSuite; 

public class CustomReporter implements IReporter{ 

@Override 

public void generateReport(List xmlSuiteSj List suitesj 



String outputDirectory) { 

//Iterating over each suite included in the test 
for (ISuite suite : suites) { 

//Following code gets the suite name 
String suiteName = suite. getNameQ; 

//Getting the results for the said suite 

Map suiteResults = suite. getResults ( ) ; 

for (ISuiteResult sr : suiteResults .values( ) ) { 

ITestContext tc = sr.getTestContextQ; 

System. out. println("Passed tests for suite + suiteName 
+ is:" + tc . getPassedTests( ) .getAllResults ( ) . size( ) ) ; 

System. out. println("Failed tests for suite + suiteName 
+ is:" + tc . getFailedTests( ) .getAllResults (). size( )) ; 

System. out. println("SI<ipped tests for suite + suiteName 
+ is:" + tc . getSkippedTests () .getAllResults (). size( )) ; 



} 



} 



} 
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} 



The preceding class implements the org.testng.IReporter interface. It 
implements the definition for the method generateReport of the IReporter 
interface. The method takes three arguments: 

• xmlSuite, which is the list of suites mentioned in the testng XML being 
executed. 

• suites, which contains the suite information after the test execution. This 
object contains all the information about the packages, classes, test 
methods, and their test execution results. 

• outputDirectory, which contains the information of the output folder 
path, where the reports will be generated. 

Create testng.xml 

Create testng.xml in C:\>TestNG_WORKSPACE to execute test case(s). 

<?xml version="1.0" encoding="UTF-8" ?> 

<suite name="Simple Reporter Suite"> 

<listeners> 

clistener class-name="CustomReporter" /> 

</listeners> 

<test name="Simple Reporter test"> 

<classes> 

<class name="SampleTest" /> 

</classes> 

</test> 

</suite> 



Compile the SampleTest, CustomReporter classes using javac. 



C : \TestNG_WORKSPACE>javac CustomReporter . java SampleTest . java 



Now, run testng.xml. 



C:\TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org. testng. TestNG 
testng.xml 



Verify the output. 




tutorialspoinfc 



62 



TestNG 



Simple Reporter Suite 

Total tests run: 3 , Failures: 1, Skips: 1 



Passed tests for suite ’Simple Reporter Suite' is:l 
Failed tests for suite 'Simple Reporter Suite' is:l 
Skipped tests for suite 'Simple Reporter Suite' is:l 

The preceding example shows a simple custom reporter, which prints the 
number of failed, passed, and skipped tests on the console for each suite 
included in the said test execution. Reporter is mainly used to generate the final 
report for the test execution. The extension can be used to generate XML, HTML, 
XLS, CSV, or text format files depending upon the report requirement. 

HTML and XML Report 

TestNG comes with certain predefined listeners as part of the library. These 
listeners are by default added to any test execution and generate different HTML 
and XML reports for any test execution. The report is generated by default under 
the folder named testoutput and can be changed to any other folder by 
configuring it. These reports consist of certain HTML and XML reports that are 
TestNG specific. 

Create Test Case Class 

Create a java class, say, SampleTest.java in C:\>TestNG_WORKSPACE. 

import org.testng. Assert; 

import org .test ng. annotations .Test; 

public class SampleTest { 

@Test 

public void testMethodOne(){ 

Assert . assertTrue(true) ; 

} 

@Test 

public void testMethodTwo(){ 
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Assert .assertTrue (false ) ; 

} 

@Test( depend sOnMet hods ={ "testMethodTwo" }) 
public void testMethodThree(){ 

Assert .assertTrue (true) ; 

} 

} 

The preceding test class contains three test methods out of which 
testMethodOne and testMethodThree will pass when executed, whereas 
testMethodTwo is made to fail by passing a false Boolean value to the 
Assert. assertTrue method, which is used for truth conditions in the tests. 

Create testng.xml 

Create testng.xml in C:\>TestNG_WORKSPACE to execute test case(s). 

<?xml version="1.0" encoding="UTF-8" ?> 

<suite name="Simple HTML-XML Suite"> 

<test name="Simple HTML-XML test"> 

<classes> 

<class name="SampleTest" /> 

</classes> 

</test> 

</suite> 

Compile the SampleTest class using javac. 

C : \TestNG_WORKSPACE>javac SampleTest .java 

Now, run the testng.xml. 

C:\TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng. TestNG 
testng.xml 

Verify the output. 
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Simple HTML -XML Suite 

Total tests run: 3 , Failures: 1, Skips: 1 



Now, go to the C:\TestNG_WORKSPACE\test-output folder. Open 
the index.html on your default web browser. You will see the following HTML 
report: 




Now, open the file C:\TestNG_WORKSPACE\test-output\testing-results.xml in the 
default XML editor on your system, and you will see the following content in the 
XML file: 
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TestNG, by default, generates multiple reports as part of its test execution. 
These reports mainly include TestNG HTML report, TestNG email-able report, 
TestNG report XML, and JUnit report XML files. These files can be found under 
the output report folder (in this case, test-output). 

This default report generation can be disabled while running the tests by setting 
the value of the property useDefaultListeners to false. This property can be set 
while using build tools like Ant or Maven. 

JUnit Reports 

JUnit is one of those unit frameworks which were initially used by many Java 
applications as a Unit test framework. By default, JUnit tests generate simple 
report XML files for its test execution. These XML files can then be used to 
generate any custom reports as per the testing requirement. We can also 
generate HTML reports using the XML files. Ant has such a utility task, which 
takes these JUnit XML files as input and generates an HTML report. 

TestNG, by default, generates JUnit XML reports for any test execution (in 
the test-output folder). We can use these XML report files as input for generating 
a JUnit HTML report. Let us take an example. 

Create Test Case Class 

Create a java class, say, SampleTest.java in C:\>TestNG_WORKSPACE. 

import org.testng. Assert; 

import org .test ng. annotations .Test; 

public class SampleTest { 

@Test 

public void testMethodOne(){ 

Assert .assertTrue (true) ; 

} 

@Test 

public void testMethodTwo(){ 

Assert . assertTrue (false ) ; 

} 

@Test ( depend sOnMet hods ={ "testMethodTwo" }) 
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public void testMethodThree(){ 

Assent . assertTnue(tnue) ; 

} 

} 

The preceding test class contains three test methods out of which 
testMethodOne and testMethodThree will pass when executed, whereas 
testMethodTwo is made to fail by passing a false Boolean value to the 
Assert. assertTrue method, which is used for truth conditions in the tests. 

Create testng.xml 

Create testng.xml in C:\>TestNG_WORKSPACE to execute test case(s). 

<?xml version="1.0" encoding="UTF-8" ?> 

<suite name="Simple Suite"> 

<test name="Simple test"> 

<classes> 

<class name="SampleTest" /> 

</classes> 

</test> 

</suite> 

Compile the SampleTest class using javac. 

C : \TestNG_WORKSPACE>javac SampleTest .java 

Now, run testng.xml. 

C:\TestNG_WORKSPACE>java -cp "C:\TestNG_WORKSPACE" org.testng. TestNG 
testng.xml 

Verify the output. 



Simple Suite 

Total tests run: 3, Failures: 1 , Skips: 1 
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Now that we have JUnit XML reports available from the above execution, let's 
create a simple Ant build configuration XML file to generate an HTML report for 
the test execution. 

Create a new file named build. xml under C:\>TestNG_WORKSPACE folder. 

<project name="TestNG_WORKSPACE" default=" junit-report" basedir=" . "> 

<!-- Sets the property variables to point to respective directories --> 
<property name="j unit -xml -dir" value= "${ based ir}/test- out put/ junit reports"/> 
cproperty name="report-dir" value="${basedir}/html-report" /> 

<!-- Ant target to generate html report --> 
ctarget name=" junit-report" > 

<!-- Delete and recreate the html report directories --> 
cdelete dir="${report-dir}" f ailonerror="false"/> 
cmkdir dir="${report-dir}" /> 
cmkdir dir="${report-dir}/lunit" /> 

<!-- Ant task to generate the html report, 
todir - Directory to generate the output reports 

fileset - Directory to look for the junit xml reports. 

report - defines the type of format to be generated. 

Here we are using "noframes" which generates a single html report. 



< junit report tod ir="${ report -dir}/ Dun it" > 
cfileset dir="${ junit-xml-dir}"> 
cinclude name="**/* .xml" /> 

</fileset> 

<report format="noframes" todir="${report-dir}/lunit" /> 

</ junitreport> 

</target> 

</project> 

The preceding XML defines a simple Ant build. xml file having a specific Ant 
target named junit-report that generates a JUnit report when executed. The 
target looks for the JUnit report XML files under the directory test- 



> 




68 



TestNG 



output/junitreports. For the Ant configuration file, the default target to execute 
is configured as junit-report. 

Open the command prompt window and go to the C:\>TestNG_WORKSPACE 
directory in the command prompt and run the command: 



C:\TestNG_WORKSPACE> ant 



Once executed, a JUnit HTML report will be generated in the configured directory 
/html-report/Junit. Open the file named junit-noframes.html on your default web 
browser. You will see the following HTML report: 




Here, we have seen how to use the JUnit XML report generated by TestNG and 
generate HTML report using Ant. There are two kinds of reports that can be 
generated using this method: frames and no-frames. 

If the report generation is configured with frames, there will be multiple files 
generated for each class and the main report will connect to them through links. 
A no-frames report consists of a single file with all the results of the test 
execution. This can be configured by providing the respective value to the 
format attribute of the report task in Ant. 
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In this chapter, we will demonstrate how to run TestNG using ANT. Let's follow 
the steps given below: 

Step 1 : Download Apache Ant 



Download the latest version of Apache Ant. 



OS 


Archive Name 


Windows 


apache-ant-1.8-4-bin.zip 


Linux 


apache-ant- 1.8. 4-bin. tar. gz 


Mac 


apache-ant- 1.8. 4-bin. tar. gz 



Step 2: Set Ant Environment 



Set the ANT_HOME environment variable to point to the base directory location, 
where ANT libraries are stored on your machine. Let's assume we've stored the 
Ant libraries in the folder apache-ant-1.8.4 folder. 



OS 


Output 


Windows 


Set the environment variable ANT_HOME to C:\Program 
Files\Apache Software Foundation\apache-ant-1.8.4 


Linux 


Export ANT_HOME=/usr/local/apache-ant-1.8.4 


Mac 


Export ANT_HOME=/Library/apache-ant-1.8.4 
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Append Ant compiler location to System Path as follows: 



OS 


Description 


Windows 


Append the string %ANT_HOME\bin at the end of the system 
variable, Path. 


Linux 


Export PATH = $PATH :$ANT_HOME/bin/ 


Mac 


Not required. 



Step 3: Download TestNG Archive 



Download the required jar files from www.testng.org. 



OS 


Archive name 


Windows 


testng-6.8.jar 


Linux 


testng-6.8.jar 


Mac 


testng-6.8.jar 



Step 4: Create Project Structure 

• Create a folder TestNGWithAnt in C:\>TestNG_WORKSPACE. 

• Create a folder src in C:\>TestNG_WORKSPACE>TestNGWithAnt. 

• Create a folder test in C:\>TestNG_WORKSPACE>TestNGWithAnt. 

• Create a folder lib in C:\>TestNG_WORKSPACE>TestNGWithAnt. 

• Create MessageUtil class in C:\>TestNG_WORKSPACE>TestNGWithAnt> 
srcfolder. 

/* 

* This class prints the given message on console. 

*/ 

public class MessageUtil { 
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private String message; 
//Constructor 

//@param message to be printed 
public MessageUtil(String message){ 
this. message = message; 

} 

// prints the message 
public void printMessage(){ 

System. out . print In (message) ; 
return message; 

} 

// add "Hi!" to the message 
public String salutationMessage( ) { 
message = "Hi!" + message; 
System. out . print In (message) ; 
return message; 



• Create TestMessageUtil class in C:\>TestNG_WORKSPACE> 
TestNGWithAnt>src folder. 

import org.testng. Assert; 

import org.testng. annotations .Test; 

public class TestMessageUtil { 

String message = "Manisha"; 

MessageUtil messageUtil = new MessageUtil(message) ; 



@Test 

public void testPrintMessageQ { 

System. out . println(" Inside testPrintMessageQ " ) ; 



} 



} 




72 



TestNG 



Assent . assert Equals (message , messagelltil . printMessage( ) ) ; 



} 



@Test 



public void testSalutationMessageQ { 

System. out . println(" Inside testSalutationMessageQ " ) ; 
message = "Hi!" + "Manisha"; 



Assent . assent Equals (message , messagelltil . salutationMessage( ) ) ; 



} 

} 



• Copy testng-6.8.jar in C:\>TestNG_WORKSPACE>TestNGWithAnt>lib 
folder. 

Create ANT buildxml 

First, we need to define the TestNG Ant task as follows: 

ctaskdef name="testng" class name= "org. testng.TestNGAntTask" > 

<classpath> 

<pathelement location="lib/testng-6. 8 . jan"/> 

</classpath> 

</taskdef > 

Then, we'll be using <testng> task in Ant to execute our TestNG test cases. 

The build. xml file is as follows: 

<pnoject name="TestNGTest" default="test" basedir="."> 

<!-- Define <testng> task --> 

<taskdef name="testng" classname="org. testng .TestNGAntTask" > 

<classpath> 

<pathelement location="lib/testng-6. 8 . jar"/> 

</classpath> 

</taskdef > 

<pnopenty name="testdin" location="test" /> 

<property name="sncdin" location="snc" /> 
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<property name="libdir" location="lib" /> 

<pnoperty name="full-compile" value="tnue" /> 

<path id="classpath.base"/> 

<path id="classpath.test"> 

<fileset dir="${libdir}" > 

<include name="**/* . jar" /> 

</fileset> 

<pathelement location="${testdir}" /> 

<pathelement location="${srcdir}" /> 

<path ref id="classpath . base" /> 

</path> 

<target name="clean" > 

< delete verbose="${full- compile}" > 

<fileset dir="${testdir}" includes="**/* • class" /> 
</delete> 

</target> 

<target name="compile" depends="clean" > 

<javac srcdir="${srcdir}" destdir="${testdir}" 
verbose="${f ull- compile}" > 

< class path refid=" classpath .test"/ > 

</ javac> 

</target> 

<target name="test" depends="compile" > 

<testng outputdir="${testdir}" classpathref=" classpath .test" > 
<xmlfileset dir="${srcdir}" includes="testng.xml"/> 

</testng> 

</target> 

</project> 

Run the following Ant command. 

C : \TestNG_WORKSPACE\TestNGWithAnt>ant 



Verify the output. 
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test : 

[testng] [TestNG] Running: 

[testng] C : \TestNG_WORKSPACE\TestNGWithAnt\src\testng .xml 
[testng] 

[testng] Inside testPrintMessage( ) 

[testng] Manisha 

[testng] Inside testSalutationMessage( ) 

[testng] HilManisha 
[testng] 

[testng] =============================================== 

[testng] Plug ANT test Suite 

[testng] Total tests run: 2, Failures: Q, Skips: 0 
[testng] =============================================== 

[testng] 

BUILD SUCCESSFUL 
Total time: 1 second 
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To set up TestNG with Eclipse, follow the steps given below: 

Step 1 : Download TestNG Archive 

Download the latest version of TestNG jar file from www.testng.org. 



OS 


Archive name 


Windows 


testng-6.8.jar 


Linux 


testng-6.8.jar 


Mac 


testng-6.8.jar 



We assume you have copied the above JAR file in C:\>TestNG folder. 

Step 2: Set Eclipse environment 

• Open eclipse -> right-click on the project and go to property -> Build Path 
-> Configure Build Path and add the testng-6.8.jar in the libraries 
using Add External Jar button. 
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• We assume that your Eclipse has inbuilt TestNG plug-in; if it is not 
available, then please get the latest version using the update site. 

o In your Eclipse IDE, select Help / Software updates / Find and Install. 

o Search for new features to install. 

o New remote site. 

o For Eclipse 3.4 and above, enter http://beust.com/eclipse. 
o For Eclipse 3.3 and below, enter http://beust.com/eclipsel. 
o Make sure the checkbox next to the URL is checked and click Next, 
o Eclipse will then guide you through the process. 

Now, your Eclipse is ready for the development of TestNG test cases. 



Step 3: Verify TestNG Installation in Eclipse 

• Create a project TestNGProject in Eclipse at any location. 

• Create a class MessageUtil to test in the project. 

/* * 

* This class prints the given message on console. 

*/ 

public class MessageUtil { 
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private String message; 
//Constructor 

//@param message to be printed 
public Messagel)til(String message){ 
this. message = message; 

} 

// prints the message 
public String printMessage( ) { 
System. out . print In (message) ; 
return message; 



• Create a test class TestNGExample in the project. 

import org.testng. Assert; 

import org. test ng. annotations .Test; 

public class TestNGExample { 

String message = "Hello World"; 

Messagelltil messagelltil = new Messagelltil(message) ; 

@Test 

public void testPrintMessageQ { 

Assert . assert Equals (message^ messagelltil . printMessage( ) ) ; 

} 



} 



} 



} 
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The project structure should be as follows: 



'P (S . 


fc) Project Explorer t! 


® = n 


i TestNGExample java £3 


* keTestNCPro|«ct 
"**src 




inport org.testng. Assert; 

import org.testng. annotations. Test; 


T £ (default package) 

► l/i MessageUtiLjava 




public class TestNGExaaple < 

String aessage ■ 'Hello World*; 

HessageUtil aessaijeutil = new HessogelltiUnessage) ; 


► ij TeslNGExAmple.java 




► a> JRE System Library [lavaSE-i. 7! 

► fi testngd 8 jar /usr/local/testng 




public void testPrlntMessagel) { 

Assert .4sserr£qua!s(«essage,nessageUtil.prlntHessage( I ) ; 

) 

> 







Finally, verify the output of the program by right-clicking on the program and 
running as TestNG. 

Verify the result. 
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*> All Tests ^ Fa led Tests Simmer* 

* ft. Default tot « Q 011 «) 

* ft; TotNGCjerrple 

* lotfYirtMosagv 10 01 ^ %) 
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* df jdafauX pubck^^Kj 

* yft MosageccKiava 

• L Tett>4C4*amfA«>fr«4 

► ■(, JUi System Library [ Jaw * 

* 3 fl^af iVxi.'kx.ii, 
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